home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Bus / T-Z / UPDATEBUILDER1.00A.CPT / Updater! Open-Me-First! < prev    next >
Text File  |  1991-11-18  |  7KB  |  77 lines

  1. Picture this...
  2.  
  3. You have just finished customizing a few figures in your huge 5 megabyte database, and you now have to send it to your client, who is across the country. He prefers to have the changes by modem that day. His modem supports a screaming 1200 baud...
  4.  
  5. or this...
  6.  
  7. You finally completed the great adventure game you wrote (you _knew_ it was possible, as you stated in the documentation) and you realize the 300k sound sample of the trumpets declaring you the winner is set at the wrong speed. (It sounds like it's being played underwater) What can you do after you fix the problem? Well... you could stick the sound in a new resource file, and explain ResEdit to the 8-year olds playing your game... or... you could re-upload the whole program (1,234,567K) to America Online at 2400 baud....hmmm.....
  8.  
  9. or even this...
  10.  
  11. Your incredible ray - trace - 3d - photo - 64Bit - touchup - fractalized - JPEGged - acceleratronic application compiles to 2.5 megs. You also want to have versions available to all of your users which support all of the processors/co-processors from the 68000 -> 68050 & the 68880 -> 68888....
  12.  
  13. ______________________________________
  14. ENTER UPDATE BUILDER & UPDATER!
  15. ______________________________________
  16.  
  17. Included in this package are two applications to simplify updating ANYTHING... The first application, Update Builder, asks you for the OLD version, and then the NEW version. Then UB crunches through the two files (which, by the way, can be _completely_ different kinds of files!), determining what has changed. It then pops out a simple document that describes the changes to the other application - Updater! Could it be any easier? When Updater! is then launched (by either simply opening the application, double clicking on the updater file, dragging the updater file to the Update! application, or dragging the old version & the updater file to the Update! application) it will re-build the older file into a new, updated version! That's all there is to it! The two programs (especially the Updater! application) are extremely tiny (35k), and hopefully will be widely distributed when the final version comes out! The Updater! application also works on a _copy_ of the original file, so if your cat decides to bite through your SCSI cable in the middle of the update, all you have to do is (well... after replacing the cable :^) ) trash the 'new' file, and start again!
  18.  
  19. ______________________________________
  20. TECHIE & PERFORMANCE NOTES
  21. ______________________________________
  22.  
  23. Update Builder plows through the two forks (data & resource) of two files. It basically determines what has been deleted, what is new, and what has changed. Updater! uses the 'older' file as a template, and builds a 'new' file with the modifications. It is _heavily_ error checked on both ends (Building and Updating) and may present a cryptic looking 'debug' dialog box. _PLEASE_ report errors-bugs-enhancements to me (along with a description (and, if possible, the actual files) of what happened and "Where" it happened (that's in the 'debug' box)) so I can fix it right away! It should be relatively bomb-proof (although, very weird, rare errors sometimes have a way of crashing out). One way to make it so bomb-idiot (myself!) proof is to write 'extra' backup data to the Updater file. You will notice that if you make a slight change in a small resource, the updater file might be a little larger than the original, but I have a feeling people would like a 'secure' update rather than a slap-patch! One way to reduce the size of the Updater file is to only "change" data, rather than inserting or deleting it. Leave yourself some room in data/resource files for updates (i.e. a "reserved" block of data). Currently, Update Builder doesn't do any "windowing" of the data (i.e. looking for shifts), it only detects where changes have occurred... for example:
  24.  
  25. Original - 0123456789RRRRRRRR
  26. New       - 0123x456789RRRRRRRR      (R=Reserved Data)
  27.  
  28. Would present a whole string of "changes" from the inserted "x" until the first "R".
  29. If, instead, you were to use the "reserved" area-
  30.  
  31. Original - 0123456789RRRRRRRR
  32. New       - 0123456789xRRRRRRR      (R=Reserved Data)
  33.  
  34.               -or-
  35.  
  36. Original - 0123456789
  37. New       - 0123456789x
  38.  
  39. There would only be one change at the "R->x" position (or concatenated at the end)... this may seem trivial in this example, but let's assume you have a 1 Meg index, and you inserted one letter at the beginning! Planning for updates is good programming practice (& quite a brain-teaser sometimes too!) so _please_ try and plan ahead!
  40.  
  41. ______________________________________
  42. VERSION HISTORY
  43. ______________________________________
  44.  
  45. 1.00a  First initial release of Update Builder & Updater
  46.  
  47.  
  48. ______________________________________
  49. THE STANDARD QUICKY DISCLAIMER
  50. ______________________________________
  51.  
  52. I assume no responsibility for anything....
  53.  
  54. (That outta do it :^) )
  55.  
  56. ______________________________________
  57. THE FUTURE
  58. ______________________________________
  59.  
  60. We'll get the "icky" stuff out of the way first....
  61.  
  62. Updater & Update Builder are in the "alpha" stages right now... I plan on revising-updating  both programs (see below) for a while to come, because I think that this type of utility has been in great need for a while! I don't plan on slapping down a fee right off the bat, because I think that there are many improvements that can be made to both applications. I _do_ plan on charging a "shareware" fee for the Update Builder application (the Updater! will _always_ be freeware), to cover for various costs involved in developing, distributing, and supporting it... Of course, those who supply information about the utilities will be generously (i.e. on the "freebie" list ) taken care of.... 'nuf said...
  63.  
  64. There are many things I would like to do to both applications, mainly to the Update Builder application. Some of these improvements would be - System 7 "savvy-ness" (currently it's compatible), Self-Compression (& Resource dependent (i.e. SND) compression), "Change" windowing, and many other aesthetics. I _sincerely_ hope that people who use _both_ programs will provide me with feedback & bug reports... This is the _best_ way to have happy peoples. Without _your_ comments, I end up dabbling in obscurities that cause "normals" to cringe. Don't let this happen! :^)
  65.  
  66. Comments, Bug Reports, Suggestions, Stinging Criticism, WarmFuzzy Praise to:
  67.  
  68. Glenn Sugden
  69. 570 Summer Drive
  70. Hollister, CA. 95023-3443
  71. 1-(408)-636-4619
  72.  
  73. CompuServe : 74730,1130
  74. America Online : SkyDiver0
  75. BBS's : Glenn Sugden
  76. ZyZZyVia : <Coming soon!>
  77.